testutils: Deprecate a bunch of ugly functions

We've by now disabled and then remved all of the tests that use these
functions because they never worked properly. So let's depecate these
functions before somebody starts using them.

diff --git a/gtk/gtktestutils.c b/gtk/gtktestutils.c
index 78bb2586fb0c23d6de165ff30b48997aeefba314..7973b0230fa40706b9aea0bc8916c1d36049ce8b 100644 (file)
--- a/gtk/gtktestutils.c
+++ b/gtk/gtktestutils.c
@@ -219,6 +219,8 @@ gtk_test_widget_send_key (GtkWidget      *widget,
  * Returns: whether all actions neccessary for the button click simulation were carried out successfully.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 gboolean
 gtk_test_widget_click (GtkWidget      *widget,
@@ -250,6 +252,8 @@ gtk_test_widget_click (GtkWidget      *widget,
  * Returns: whether all actions neccessary for the button click simulation were carried out successfully.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 gboolean
 gtk_test_spin_button_click (GtkSpinButton  *spinner,
@@ -464,6 +468,8 @@ gtk_test_find_widget (GtkWidget    *widget,
  * @percentage argument.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 void
 gtk_test_slider_set_perc (GtkWidget      *widget,
@@ -496,6 +502,8 @@ gtk_test_slider_set_perc (GtkWidget      *widget,
  * Returns: gtk_adjustment_get_value (adjustment) for an adjustment belonging to @widget.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 double
 gtk_test_slider_get_value (GtkWidget *widget)
@@ -517,6 +525,8 @@ gtk_test_slider_get_value (GtkWidget *widget)
  * GtkEditable (entry and text widgets) or GtkTextView.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 void
 gtk_test_text_set (GtkWidget   *widget,
@@ -547,6 +557,8 @@ gtk_test_text_set (GtkWidget   *widget,
  * Returns: new 0-terminated C string, needs to be released with g_free().
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 gchar*
 gtk_test_text_get (GtkWidget *widget)
@@ -583,6 +595,8 @@ gtk_test_text_get (GtkWidget *widget)
  * Returns: (transfer none): a newly created widget.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  */
 GtkWidget*
 gtk_test_create_widget (GType        widget_type,
@@ -641,6 +655,8 @@ test_increment_intp (int *intp)
  * Returns: (transfer full): a widget pointer to the newly created GtkWindow.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 GtkWidget*
 gtk_test_display_button_window (const gchar *window_title,
@@ -683,6 +699,8 @@ gtk_test_display_button_window (const gchar *window_title,
  * Returns: (transfer none): a widget pointer to the newly created GtkWindow.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 GtkWidget*
 gtk_test_create_simple_window (const gchar *window_title,

diff --git a/gtk/gtktestutils.h b/gtk/gtktestutils.h
index badbd1f372df37418dfe0a208e0f9898adcebeb6..bdf2515fcc53490ab04ac593d0d507b22a29e828 100644 (file)
--- a/gtk/gtktestutils.h
+++ b/gtk/gtktestutils.h
@@ -41,29 +41,29 @@ GDK_AVAILABLE_IN_ALL
 GtkWidget*      gtk_test_find_widget            (GtkWidget      *widget,
                                                  const gchar    *label_pattern,
                                                  GType           widget_type);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 GtkWidget*      gtk_test_create_widget          (GType           widget_type,
                                                  const gchar    *first_property_name,
                                                  ...);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 GtkWidget*      gtk_test_create_simple_window   (const gchar    *window_title,
                                                  const gchar    *dialog_text);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 GtkWidget*      gtk_test_display_button_window  (const gchar    *window_title,
                                                  const gchar    *dialog_text,
                                                  ...); /* NULL terminated list of (label, &int) pairs */
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 void            gtk_test_slider_set_perc        (GtkWidget      *widget, /* GtkRange-alike */
                                                  double          percentage);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 double          gtk_test_slider_get_value       (GtkWidget      *widget);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 gboolean        gtk_test_spin_button_click      (GtkSpinButton  *spinner,
                                                  guint           button,
                                                  gboolean        upwards);
 GDK_AVAILABLE_IN_3_10
 void            gtk_test_widget_wait_for_draw   (GtkWidget      *widget);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 gboolean        gtk_test_widget_click           (GtkWidget      *widget,
                                                  guint           button,
                                                  GdkModifierType modifiers);
@@ -72,10 +72,10 @@ gboolean        gtk_test_widget_send_key        (GtkWidget      *widget,
                                                  guint           keyval,
                                                  GdkModifierType modifiers);
 /* operate on GtkEntry, GtkText, GtkTextView or GtkLabel */
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 void            gtk_test_text_set               (GtkWidget      *widget,
                                                  const gchar    *string);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 gchar*          gtk_test_text_get               (GtkWidget      *widget);
 
 /* --- Gtk+ Test low-level API --- */